Skip to content

Conversation

@ethanpalm
Copy link
Collaborator

@ethanpalm ethanpalm commented Dec 11, 2025

Documentation changes

Part of https://linear.app/mintlify/issue/DOC-214/qanda-bot-launches-slack-discord-telegram


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Note

Add Discord bot documentation and link it in the Optimize section navigation.

  • Documentation:
    • New page ai/discord.mdx detailing the Discord bot: availability, behavior (@ mentions and #ask-ai), setup steps, and management, with illustrative images.
  • Navigation:
    • Add ai/discord to docs.json under Optimize > pages (English) alongside other AI integrations.

Written by Cursor Bugbot for commit 9374a3c. This will update automatically on new commits. Configure here.

ai/discord.mdx Outdated
1. Authorize the bot to access your server.
1. Add the bot to any channels you want it to be available in.

## Configure the Discord bot
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

overall im not a huge fan of docs that kinda walk u thru the UI - imo we failed in the UI when that happens. A couple of the sections here are like that.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Feels like a fair assumption that if someone is setting up a Mintlify Discord bot, they're already familiar with Discord and not learning to use it. Will revise

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ill always assume that people will skim/not read everything too. i think adding a picture of this will be good; however, i want to iterate on the design before we include it lol

Image

@ethanpalm ethanpalm merged commit 7bb754a into main Dec 12, 2025
5 checks passed
@ethanpalm ethanpalm deleted the discord-bot branch December 12, 2025 18:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants